home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 November / Macworld (1999-11).dmg / Shareware World / Info / For Developers / Smile1.6.6.sea / Smile1.6.6 / Smile ƒ / Help files / Text window < prev    next >
Text File  |  1999-08-03  |  5KB  |  89 lines

  1. Text Window
  2.  
  3.  
  4. Smile's text windows
  5.  
  6. Text windows  are multipurpose and can be used for text editing, as a calculator and for scripting, especially script debugging. Text windows offer a superior environment to edit and debug scripts, before the final making of an applet or droplet. (Text windows do not support making applets and droplets ; use a script window for that purpose.) 
  7.  
  8.  
  9. Getting started with Text windows
  10.  
  11. • Open a new text window by selecting "New text" ( N, "File" menu).
  12.  
  13. The new window will be the active (frontmost) window and will be "untitled."  It can be moved and sized.
  14.  
  15. • Smile text windows are white in color. (Script windows have a color depending on the preference setting.) 
  16.  
  17. • A new text window will be a basic window, with no buttons installed. Buttons add functionality and can be added to text windows by dragging. Buttons are discussed elsewhere. 
  18.  
  19. • Each window includes a size box, a vertical scroll bar, a zoom-box, and a close box. 
  20.  
  21. • Smile supports having multiple text windows open at the same time. Each text window "has its own undo". When you make a window active, you can undo the last action performed even if it was performed a long time ago - provided the changes have not been saved.
  22.  
  23. • Text windows are saved by selecting "Save" or "Save as..." ("File" menu). The saved text window is saved as a "TEXT" file which has the standard Smile test icon. Smile text files can be opened by other text editors and word processors. 
  24.  
  25. • When changes have been made to a text window, and it is saved, its position on the screen and its size are also saved. On reopening, the window will be presented at its previous position, and with its previous size.
  26.  
  27. Changes refer to the editing of text or the adding of deleting of buttons to the text window. Simply changing the position on the screen or the size of a text window is not considered a change. If you want the window position or size to be remembered, make a trivial change to the text and then "Save" ("File" menu) 
  28.  
  29. • -click the title of any window to open a local pull-down menu which displays its path (if any). Selecting an item of this menu reveals the corresponding folder in the Finder. The "title" is at the center of the top bar of the window. The window must have a title for the pull-down menu to be displayed. (It will not work if the window is "untitled." ) This feature works with text, Worksheet, output and script windows. 
  30.  
  31.  
  32. Text editing
  33.  
  34. Smile text windows function similarly to other text editors of which you are likely to be familiar. Text can be edited using the Smile editing tools available from the menus, shortcut keys, mouse and drop-and-drag.
  35.  
  36. Your newly opened text window has a default line-width setting. This setting establishes the number of characters that fit on one line. The line-width can be set for each window on an individual basis using "Line width...", in the "Text" menu. 
  37.  
  38. Try the following choices from the "Text" menu :
  39.  
  40. • Font selection. 
  41. • Font size 
  42. • Styled text 
  43. • Colored text 
  44.  
  45. Try the following choices form the "Edit menu" : 
  46.  
  47. • Undo
  48. • Cut 
  49. • Paste
  50. • Clear 
  51. • Select all 
  52.  
  53.  
  54. Using drag-and-drop in text windows
  55.  
  56. Text windows (and all other Smile windows as well) support drag-and-drop which will come to good use during your editing activities.
  57.  
  58. Use drag-and-drop to perform the following : 
  59.  
  60. • Rearrange text within a given text window.
  61. • Drag text to another window within Smile.
  62. • Make a clipping outside of Smile.
  63. • Drag-and-drop a clipping from outside Smile onto a text window. 
  64. • Move a block of selected text to another application using drag-and-drop. 
  65. • Drag a block of selected text from another application onto a Smile text window.
  66. • Drag an existing Smile text file onto a text window to open it. 
  67. • Drag an existing Smile script file onto a text window to open it. 
  68.  
  69. Drag-and-drop works conventionally within Smile. That is, when selected text is dragged within a given window, the text is "moved" from the original location to the new location. However, when the selected text is dragged from one window to another, it is "copied" to the new location.
  70.  
  71. ========================================================
  72.  
  73. Advanced
  74.  
  75. • Text windows can be used as a mean to obtain easily some information about various Smile objects. This applies to the dialog items in custom dialogs, and to the buttons in graphic windows.
  76. Dropping such an object onto a text window will insert at the drop location (as string) the record of the properties of the object. It is the same string which can also be obtained as the result of the following script :
  77. ----------------------------
  78. theObject as record
  79. ----------------------------
  80.  
  81. assuming that "theObject" contains a reference to the object.
  82.  
  83. If the Command key () is held down while the object is dropped on a text window, the string inserted in the text will be the (unique, by id number) reference to the object. Such a reference can look like :
  84. ----------------------------
  85. dialog item id 3 of dialog id 2
  86. ----------------------------
  87.  
  88. ========================================================
  89.